home *** CD-ROM | disk | FTP | other *** search
/ SGI Varsity Update 1998 August / SGI Varsity Update 1998 August.iso / dist / dist6.4 / pvm.idb / usr / share / catman / u_man / cat1 / pvmd3.z / pvmd3
Text File  |  1998-07-29  |  18KB  |  342 lines
  1. PVMD3(1)                                               Last changed: 5-8-98
  2.  
  3.  
  4. NNAAMMEE
  5.      ppvvmmdd33 - Starts the Parallel Virtual Machine (PVM) daemon
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ppvvmmdd33 [_o_p_t_i_o_n_s] [_h_o_s_t_f_i_l_e]
  9.  
  10. IIMMPPLLEEMMEENNTTAATTIIOONN
  11.      UNICOS, UNICOS/mk, and IRIX systems
  12.  
  13.      Cray Research and Silicon Graphics offer two release packages that
  14.      include PVM libraries; they are referred to as the CRAY T3D version
  15.      and the MPT version.  For more information about the MPT version, see
  16.      the _M_e_s_s_a_g_e _P_a_s_s_i_n_g _T_o_o_l_k_i_t:  _P_V_M _P_r_o_g_r_a_m_m_e_r'_s _M_a_n_u_a_l, publication SR-
  17.      2196.
  18.  
  19.      This command is not available in the following release packages:
  20.  
  21.           CRAY T3D version
  22.  
  23.           MPT version in stand-alone mode
  24.  
  25. DDEESSCCRRIIPPTTIIOONN
  26.      The ppvvmmdd33 command starts the Parallel Virtual Machine (PVM) daemon.
  27.      This user-level daemon process allows coordination between systems in
  28.      a PVM virtual machine.  One daemon must run on each system.  These
  29.      daemons provide the communication and process control functions needed
  30.      by PVM processes.
  31.  
  32.      You can start the local daemon manually with a host file option that
  33.      automatically starts the remote daemons.  It can be started by a shell
  34.      script, $$PPVVMM__RROOOOTT//lliibb//ppvvmmdd, or by starting the executable file
  35.      directly, $$PPVVMM__RROOOOTT//lliibb//$$PPVVMM__AARRCCHH//ppvvmmdd33.  You can also start the local
  36.      and remote daemons on the PVM console by using the ppvvmm(1) command.
  37.  
  38.      On UNICOS and UNICOS/mk systems, use of MPT requires the Cray
  39.      Programming Environment 3.0 releases or later, and requires use of
  40.      Modules software.  Use the Modules software package to install both
  41.      the Programming Environment and MPT.  To use MPT software, load the
  42.      mmpptt module in addition to loading the Programming Environment module.
  43.      For information on using modules, see _I_n_s_t_a_l_l_i_n_g _P_r_o_g_r_a_m_m_i_n_g
  44.      _E_n_v_i_r_o_n_m_e_n_t _P_r_o_d_u_c_t_s, publication SG-5191, or if the Programming
  45.      Environment has already been installed on your system, see the online
  46.      ASCII file, //oopptt//ccttll//ddoocc//RREEAADDMMEE.  After you have initialized modules,
  47.      to access the MPT software, enter the following command:
  48.  
  49.           module load mpt
  50.  
  51.      When you use the MPT version of PVM, $$PPVVMM__RROOOOTT and $$PPVVMM__AARRCCHH are set
  52.      automatically for you when the mmpptt module is loaded.
  53.  
  54.      On IRIX systems, the use of Modules software is optional.  However,
  55.      IRIX users can set the following environment variables:
  56.  
  57.      * If PVM is installed in a standard location, set PPVVMM__RROOOOTT to
  58.        //uussrr//aarrrraayy//PPVVMM.  Otherwise, use the appropriate value.
  59.  
  60.      * Set PPVVMM__AARRCCHH to the appropriate architecture type (see the
  61.        ppvvmm__iinnttrroo(1) man page).
  62.  
  63.      * Add $$PPVVMM__RROOOOTT//lliibb and $$PPVVMM__RROOOOTT//bbiinn//$$PPVVMM__AARRCCHH to the PPAATTHH
  64.        environment variable.
  65.  
  66.      Entering the hhaalltt command on the PVM console is the preferred method
  67.      of stopping every daemon.  (For information on using the PVM console,
  68.      see the ppvvmm(1) command.)  This command kills all PVM tasks, all remote
  69.      daemons, the local daemon, and finally the console itself.  If the
  70.      master daemon is killed manually, it sends a SSIIGGTTEERRMM signal to allow
  71.      it to kill the remote daemon and to clean up various files.
  72.  
  73.      If the daemon is killed in a manner that leaves behind the UNICOS or
  74.      UNICOS/mk //ttmmpp//ppvvmmdd.._u_i_d file or the IRIX //ttmmpp//ppvvmmdd.._u_i_d.._v_m_i_d ffiillee oonn
  75.      oonnee oorr mmoorree ssyysstteemmss,, ddeelleettee tthhee ffiillee..  IIff tthhee ffiillee rreemmaaiinnss,, iitt ccaann
  76.      pprreevveenntt PPVVMM ffrroomm rreessttaarrttiinngg oonn tthhaatt ssyysstteemm..
  77.  
  78.      The ppvvmmdd33 command accepts the following options and operand:
  79.  
  80.      _o_p_t_i_o_n_s   Specifies one or more of the following options:
  81.  
  82.                --dd_m_a_s_k    Sets the PVM daemon debug mask.  You can use this
  83.                          option to debug the ppvvmmdd33 command (not application
  84.                          programs).
  85.  
  86.                          The _m_a_s_k variable is a hexadecimal number that is
  87.                          the sum of the following bits:
  88.  
  89.                          1    Packet routing
  90.  
  91.                          2    Message routing and entry points
  92.  
  93.                          4    Task state
  94.  
  95.                          8    Slave pvmd startup
  96.  
  97.                          10   Host table updates
  98.  
  99.                          20   Select loop (below packet layer)
  100.  
  101.                          40   IP network
  102.  
  103.                          80   Multiprocessor nodes
  104.  
  105.                          100  Resource manager interface
  106.  
  107.                          200  Application (messages with no destination,
  108.                               and so on)
  109.  
  110.                          400  Shared memory operations
  111.  
  112.                          800  Semaphones
  113.  
  114.                          1000 Locks
  115.  
  116.                --hh        Specifies automatic creation of the host file by
  117.                          using NQE.  If _h_o_s_t_f_i_l_e is also specified, the
  118.                          options from that host file are used but the host
  119.                          is started only if NQE includes it in its list of
  120.                          available hosts.  This option is not supported on
  121.                          UNICOS/mk or IRIX systems.
  122.  
  123.                --nn_n_a_m_e    Specifies an alternate host name for the master
  124.                          daemon to use.  You must use the same name to
  125.                          identify the configuration information in the host
  126.                          file.
  127.  
  128.                The following options, which the master daemon uses when
  129.                starting remote systems, are available to programmers
  130.                writing host starter applications.  (See the
  131.                ppvvmm__rreegg__hhoosstteerr(3) function.)
  132.  
  133.                --ss   Starts the PVM daemon in remote mode.  You cannot use a
  134.                     host file and must supply the following parameters:
  135.                     _m_a_s_t_e_r _p_v_m_d _i_n_d_e_x, _m_a_s_t_e_r _I_P, _m_a_s_t_e_r _M_T_U, _r_e_m_o_t_e _p_v_m_d
  136.                     _i_n_d_e_x, and _r_e_m_o_t_e _I_P.
  137.  
  138.                --SS   Starts the PVM daemon in remote mode, but the remote
  139.                     PVM daemon does not wait for its ssttddiinn file to be
  140.                     closed after printing its parameters.  Use this option
  141.                     for manual startup.
  142.  
  143.                --ff   Ensures that the remote PVM daemon does not fork after
  144.                     configuration.  This option is useful if the remote
  145.                     daemon is to be controlled or monitored by some
  146.                     process.
  147.  
  148.      _h_o_s_t_f_i_l_e  Specifies the host file that contains the names of the
  149.                systems in the virtual machine.  For host file and option
  150.                information, see the "Host File Format" and "Host File
  151.                Options" subsections.
  152.  
  153.    HHoosstt FFiillee FFoorrmmaatt
  154.      Each system that the daemon should include in the virtual machine must
  155.      have an entry in the host file, with the exception of the local
  156.      daemon.  The machine that runs the local daemon is always included in
  157.      the virtual machine.  To specify options for the local daemon, its
  158.      name must be specified in the host file with the appropriate options.
  159.      The name that identifies the local machine should be the name returned
  160.      by the hhoossttnnaammee command on your system.  Alternatively, the --nn option
  161.      can be used to specify an alternate host name to be used in the host
  162.      file.  To use a particular network interface, use the --iipp option to
  163.      specify the interface name.
  164.  
  165.      If NQE is available, automatic creation of the list of hosts in the
  166.      virtual machine can be requested by using the --hh option.  The policy
  167.      called PVM is used to request a list of hosts.  For more information
  168.      on policies, see the _N_Q_E _U_s_e_r'_s _G_u_i_d_e, publication SG-2148.
  169.  
  170.      If a host file is specified with the --hh option, the options are read,
  171.      but only the hosts returned from NQE are started as part of the
  172.      virtual machine.  If default options are acceptable to the user, it is
  173.      not necessary to specify a host file.
  174.  
  175.      The following example shows the format of a host file:
  176.  
  177.       # my first host file
  178.       gust.cray.com
  179.       fred dx=$PVM_ROOT/lib/$PVM_ARCH/pvmd3
  180.       wilma ep=/cray/uss/ptmp/mylogin/text dx=$PVM_ROOT/lib/$PVM_ARCH/pvmd3
  181.  
  182.      This sample file contains the names of the three systems in the
  183.      virtual machine.  Lines beginning with a # symbol, optionally preceded
  184.      by white space, are ignored.
  185.  
  186.      The master daemon (master system or host) for a group is started by
  187.      hand on the local system, and it starts slaves on each of the
  188.      remaining systems using the remote shell rreemmsshh(1) (on UNICOS or
  189.      UNICOS/mk systems) or aarrsshheellll(1) (on IRIX systems with Array Services
  190.      installed) or rrsshh(1) (on IRIX systems without Array Services
  191.      installed).  The master system can have an entry in the host file,
  192.      which is identified with the name returned from the hhoossttnnaammee command
  193.      or the name specified with the --nn option.  Host names cannot be
  194.      numeric (IP) addresses, because they are passed to rrsshh() or rreemmsshh,
  195.      which usually do not accept addresses.
  196.  
  197.      You can change the default options in the host file by adding a line
  198.      with an asterisk in the first field followed by the options, as shown
  199.      in the following example:
  200.  
  201.           ** lloo==aaffrriieenndd ssoo==ppww
  202.  
  203.      This sets new default values for lloo and ssoo==ppww for the systems in the
  204.      remainder of the host file or until the option is reset by another
  205.      line with an asterisk.
  206.  
  207.      A dollar sign ( $ ) in an option introduces an environment variable
  208.      name, for example, $$PPVVMM__AARRCCHH.  Names are expanded from environment
  209.      variables by each PVM daemon.
  210.  
  211.      Your application may use the ppvvmm__aaddddhhoossttss(3) function to add a new
  212.      system to the virtual machine, but it may be necessary to define
  213.      options such as ddxx or eepp for this system.  If you prefix the
  214.      appropriate host file line with an ampersand (&), the PVM daemon will
  215.      save the information but will not start a daemon on that system until
  216.      you call ppvvmm__aaddddhhoossttss(3), as shown in the following example:
  217.  
  218.           & poplar dx=$PVM_ROOT/lib/$PVM_ARCH/pvmd3
  219.  
  220.      This host file entry will not start a daemon on ppooppllaarr, but if a
  221.      request is received later, PVM will use the indicated path for the PVM
  222.      daemon.
  223.  
  224.    HHoosstt FFiillee OOppttiioonnss
  225.      For complex configurations, you can specify the following options
  226.      after any system name in the host file.
  227.  
  228.      bbxx==_d_p_a_t_h    Specifies the debugger path.  You can also set this path
  229.                  by using the PPVVMM__DDEEBBUUGGGGEERR environment variable.  The
  230.                  default is $$PPVVMM__RROOOOTT//lliibb//ddeebbuuggggeerr.
  231.  
  232.      ddxx==_l_o_c      Specifies a location for the PVM daemon other than the
  233.                  default, $$PPVVMM__RROOOOTT//lliibb//ppvvmmdd.  This option is useful in
  234.                  debugging new versions of PVM.  _l_o_c may be a simple file
  235.                  name, an absolute path name, or a path relative to the
  236.                  user's home directory on the remote system.  When the MPT
  237.                  version is installed on UNICOS or IRIX systems, the ppvvmmdd33
  238.                  command is installed in $$PPVVMM__RROOOOTT//lliibb//$$PPVVMM__AARRCCHH//ppvvmmdd33 and
  239.                  the start-up script is installed in //$$PPVVMM__RROOOOTT//lliibb//ppvvmmdd.
  240.                  You might want to set ddxx to either of these paths in host
  241.                  file entries for these systems.
  242.  
  243.      eepp==_p_a_t_h_s    Specifies a series of paths to search for the requested
  244.                  files to spawn on the system.  A percent sign (%) in the
  245.                  path expands to the architecture of the remote system.
  246.                  Multiple paths are separated by a colon.  The default is
  247.                  $$HHOOMMEE//ppvvmm33//bbiinn//$$PPVVMM__AARRCCHH:: $$PPVVMM__RROOOOTT//bbiinn//$$PPVVMM__AARRCCHH.
  248.  
  249.      lloo==_u_s_e_r_i_d   Specifies an alternate login name for the system.  The
  250.                  default is the login name on the master system.
  251.  
  252.      ssoo==mmss       Causes the master PVM daemon to request that you manually
  253.                  start a PVM daemon on a remote system when the rrsshh or
  254.                  aarrsshheellll (or rreemmsshh) and rreexxeecc(3C) network services are
  255.                  disabled, but IP connectivity exists.  The default is
  256.                  false.  (This option is rarely used.)  You cannot start
  257.                  the master system from the PVM console or background when
  258.                  you are using this option.
  259.  
  260.      ssoo==ppww       Causes PVM to prompt for a password for the remote system.
  261.                  This option is useful when you have a different login name
  262.                  and password on a remote system.  The master host prompts
  263.                  you for your password as follows:
  264.  
  265.                       Password (honk.cs.utk.edu:manchek):
  266.  
  267.                  Enter your password for the remote system.  Startup will
  268.                  then continue as normal.  You cannot start the master host
  269.                  from the PVM console or background when you are using this
  270.                  option.  The PVM daemon uses the rreexxeecc(3C) function
  271.                  instead of rrsshh or rreemmsshh or aarrsshheellll.
  272.  
  273.      sspp==_v_a_l_u_e    Specifies the relative computational speed of the system
  274.                  compared to other system in the configuration.  _v_a_l_u_e is
  275.                  an integer in the range 1 through 1,000,000.  The default
  276.                  is 1000.  (This option currently has no effect on PVM
  277.                  operation.)
  278.  
  279.      wwdd==_p_a_t_h     Specifies a working directory in which all spawned tasks
  280.                  on the host will execute.  The default is $$HHOOMMEE.
  281.  
  282.      iipp==_n_e_t_w_o_r_k__n_a_m_e
  283.                  Specifies the network name to be used for communication.
  284.                  The default is determined by the network routing, as shown
  285.                  by the nneettssttaatt --ii command.  You can use this option to
  286.                  specify HIPPI or another specific device.
  287.  
  288. EEXXAAMMPPLLEESS
  289.      The following examples illustrate how to use options in a host file:
  290.  
  291.      Example 1:
  292.  
  293.           # host file for testing on various platforms
  294.           fonebone
  295.           refuge
  296.           # installed in /usr/local/here
  297.           sigi.cs            dx=$PVM_ROOT/lib/pvmd
  298.           # borrowed accts, "guest", don't trust fonebone
  299.           *                  lo=guest  so=pw
  300.           sn666.jrandom.com
  301.           cubie.misc.edu
  302.           # really painful one, must start it by hand and share a homedir
  303.           igor.firewall.com  lo=guest2  so=ms  ep=bob/pvm3/bin/%
  304.  
  305.      Example 2:
  306.  
  307.           # host file for using hippi network.
  308.           # The hosts are normally referred to as gust and cool.
  309.           # NOTE:   Do not use the -n option to specify gust-hippi.
  310.           #    This causes a configuration with 3 machines named
  311.           #    gust, gust-hippi, and cool.  Since gust-hippi doesn't
  312.           #    appear in the host file, it has default options
  313.           #    associated with it.  This can be VERY confusing.
  314.           gust ip=gust-hippi
  315.           cool ip=cool-hippi
  316.  
  317. FFIILLEESS
  318.      //ttmmpp//ppvvmmdd.._u_i_d                 PVM daemon file, containing socket
  319.                                    information
  320.  
  321.      //ttmmpp//ppvvmmll.._u_i_d                 PVM log file, containing text written to
  322.                                    the ssttddoouutt and ssttddeerrrr files
  323.  
  324.      $$PPVVMM__RROOOOTT//lliibb//ppvvmmdd            PVM daemon start-up script
  325.  
  326.      $$PPVVMM__RROOOOTT//lliibb//$$PPVVMM__AARRCCHH//ppvvmmdd33 PVM daemon executable file
  327.  
  328.      $$PPVVMM__RROOOOTT//lliibb//ddeebbuuggggeerr        Debugger script
  329.  
  330. SSEEEE AALLSSOO
  331.      ppvvmm(1), ppvvmm__iinnttrroo(1), ppvvmm__aaddddhhoossttss(3), ppvvmm__rreegg__hhoosstteerr(3)
  332.  
  333.      rreemmsshh(1B) in the _U_N_I_C_O_S _U_s_e_r _C_o_m_m_a_n_d_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR
  334.      -2011.  (On other systems, you may want to use rrsshh() or rreemmsshh(),
  335.      whichever is the appropriate remote shell for your system.)
  336.  
  337.      _N_Q_E _U_s_e_r'_s _G_u_i_d_e, publication SG-2148
  338.  
  339.      _M_e_s_s_a_g_e _P_a_s_s_i_n_g _T_o_o_l_k_i_t:  _P_V_M _P_r_o_g_r_a_m_m_e_r'_s _M_a_n_u_a_l, publication SR-2196
  340.  
  341.      This man page is available only online.
  342.